'\" t
.\"     Title: bugle-eps
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: October 2007
.\"    Manual: Bugle user manual
.\"    Source: BUGLE 0.0.20150628
.\"  Language: English
.\"
.TH "BUGLE\-EPS" "7" "October 2007" "BUGLE 0.0.20150628" "Bugle user manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
bugle-eps \- captures vector graphics representatios of scenes
.SH "SYNOPSIS"
.sp
.nf
filterset eps
{
    filename "\fIscreenshot\&.eps\fR"
    key_eps "\fIkey\fR"
    title "\fIMy screenshot\fR"
    bsp "\fIno\fR"
    buffer "\fI10000000\fR"
}
.fi
.SH "DESCRIPTION"
.PP
This screenshot is similar to
\fBbugle-screenshot\fR(7), but instead of a raster image, it produces a vector graphic suitable for printing\&. This is achieved through
\m[blue]\fBgl2ps\fR\m[]\&\s-2\u[1]\d\s+2, which is incorporated into
bugle\&. The supported formats are Postscript, Encapsulated Postscript (EPS), Portable Document Format (PDF) and Scalable Vector Graphic
SVG)\&.
.PP
The capturing process utilises the OpenGL feedback buffer (see
\fBglFeedbackBuffer\fR(3)), which creates some inherent limitations\&. No per\-fragment effects (such as texturing or bitmap rendering) are captured, not will vertex programs work correctly\&. Essentially, the colour of each vertex must be either directly specified or determined by the OpenGL lighting model\&.
.SH "OPTIONS"
.PP
\fBfilename\fR
.RS 4
The file to which the screenshot will be written\&. The extension is used to determine the file format\&. Valid extensions are
\&.ps,
\&.eps,
\&.pdf
and
\&.svg\&.
.RE
.PP
\fBkey_eps\fR
.RS 4
The key\-press which triggers the snapshot\&.
.RE
.PP
\fBtitle\fR
.RS 4
The title that is embedded in Postscript and
EPS
files\&.
.RE
.PP
\fBbsp\fR
.RS 4
If this boolean is enabled, the depth sorting is done with a
BSP
tree to give accurate results\&. This may be necessary to get correct results in scenes with complex occlusion, but it is much slower\&.
.RE
.PP
\fBbuffer\fR
.RS 4
The number of entries to allocate for the feedback buffer\&. If this is too low, the feedback buffer will overflow and the screenshot will fail\&. The default should be enough for most simple scenes, but for highly complex scenes it may be necessary to create a larger buffer\&.
.RE
.SH "AUTHOR"
.PP
bugle
is written and maintained by
Bruce Merry\&.
.SH "SEE ALSO"
.PP
\fBbugle\fR(3),
\fBglFeedbackBuffer\fR(3)
.SH "NOTES"
.IP " 1." 4
gl2ps
.RS 4
\%http://www.geuz.org/gl2ps/
.RE
